IRIX Base Documentation 1998 November

home *** CD-ROM | disk | FTP | other *** search

/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / kunarc.z / kunarc

Wrap

Text File | 1998-10-30 | 13KB | 331 lines

KKKKUUUUNNNNAAAARRRRCCCC((((1111)))) KKKK----AAAASSSShhhhaaaarrrreeee bbbbyyyy XXXXiiiinnnneeeetttt ((((11117777 JJJJaaaannnn 1111999999998888 8888....7777)))) KKKKUUUUNNNNAAAARRRRCCCC((((1111)))) NNNNAAAAMMMMEEEE kunarc, karc - K-AShare AppleSingle/AppleDouble/BinHex/MacBinary converter SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS kkkkuuuunnnnaaaarrrrcccc [ -_t_r_U ] [ -_f _o_u_t_f_i_l_e ] _i_n_f_i_l_e... kkkkaaaarrrrcccc [ -_t_r_A_B_C_D_M ] [ -_f _o_u_t_f_i_l_e ] _i_n_f_i_l_e... DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN These utility programs let the user convert between various Macintosh archival formats and the K-AShare file format. The supported archive formats are AppleSingle, AppleDouble, BinHex, CAP-AUFS 3.0, Helios Ethershare, MacBinary, TOPS (version 2 or later), and IPT uShare 4.1. These formats are used to encode Macintosh specific information (file type and creator, resource fork etc.) into one or more files that can be stored on non-Macintosh file systems. BinHex also encodes files into ASCII, so that they can be transferred via e-mail (i.e. it is similar to _u_u_e_n_c_o_d_e(_1) ). AppleDouble is used by some other AppleShare emulators to store Macintosh files on Unix filesystems (e.g. A/UX, GatorShare, and NFS/Share). AppleSingle is used by AppleLink to attach files to e-mail messages. _K_a_r_c creates archive files from K-AShare files, _k_u_n_a_r_c creates K-AShare files from archive files. BinHex files usually have a .hqx file suffix. AppleDouble format uses two files. For instance, for a file named foo, only the macintosh data fork will be stored in the file named foo. The resource fork, file creator, type, modification date, etc. are stored in a file named %foo. _K_u_n_a_r_c should be run on the file that starts with the '%' character. Helios Ethershare and IPT uShare files have a .rsrc subdirectory which contains the resource fork of the file contained in the upper directory. Helios Ethershare files with no dataforks only have an entry in this .rsrc subdirectory. Using _k_u_n_a_r_c on IPT uShare requires using the -U option. _k_u_n_a_r_c should be run given the name of the .rsrc subdirectory, and will then convert all files in the subdirectory. A side effect of running _k_u_n_a_r_c on Helios Ethershare and IPT uShare files is that filenames with 8 bit characters (accents and the like) will get renamed using Xinet's 8 bit character mapping. Helios EtherShare and IPT uShare file systems should also have their directory names changed using _k_u_n_a_r_c with the -h option. See the examples. MacBinary files usually have a .bin suffix. The _k_u_n_a_r_c Page 1 (printed 3/26/98) KKKKUUUUNNNNAAAARRRRCCCC((((1111)))) KKKK----AAAASSSShhhhaaaarrrreeee bbbbyyyy XXXXiiiinnnneeeetttt ((((11117777 JJJJaaaannnn 1111999999998888 8888....7777)))) KKKKUUUUNNNNAAAARRRRCCCC((((1111)))) utility supports BinHex 4.0 and MacBinary I & II files. Note that AppleSingle files received from AppleLink via UNIX mail must be run through _u_u_d_e_c_o_d_e first. _K_u_n_a_r_c does support compressed AppleLink enclosures, but the AppleLink software or Stuffit Expander must be used to uncompress the resulting file. _K_u_n_a_r_c will use the file name recorded in the archive file, for every _i_n_f_i_l_e that is not preceded by an _o_u_t_f_i_l_e argument. If you don't use the remove _i_n_f_i_l_e option with _k_a_r_c, you must specify an _o_u_t_f_i_l_e. OOOOPPPPTTTTIIIIOOOONNNNSSSS ----ffff Use the next argument as the name of _o_u_t_f_i_l_e. If _o_u_t_f_i_l_e does not contain a path name, the current working directory will be used (rather than any path name that may be contained in _i_n_f_i_l_e). If this option is omitted, we try to determine the output filename from _i_n_f_i_l_e (and _o_u_t_f_i_l_e will be placed in the same directory as _i_n_f_i_l_e). If _o_u_t_f_i_l_e is given as `-', karc writes to the standard output. ----rrrr Remove _i_n_f_i_l_e after converting it. ----hhhh Convert _i_n_f_i_l_e Helios EtherShare or IPT uShare directory names, and all subdirectory names, to use Xinet's 8 bit character encoding scheme. This option should be run by itself either before or after converting all the files from Helios EtherShare or IPT uShare format to Xinet format. See the examples below. ----tttt Set the tolerant flag. When this flag is set, kunarc tries to handle apparently invalid files. This is useful for handling files created by programs that do not exactly follow the appropriate file format standard. ----AAAA Create an AppleSingle archive. ----BBBB Create a BinHex archive. ----CCCC Create a CAP/AUFS version 3 archive. ----DDDD Create an AppleDouble archive. ----MMMM Create a MacBinary archive. ----UUUU Assume input infile is a IPT uShare file (uShare files are not automatically recognized as they lack an easy "magic" number to recognize). Page 2 (printed 3/26/98) KKKKUUUUNNNNAAAARRRRCCCC((((1111)))) KKKK----AAAASSSShhhhaaaarrrreeee bbbbyyyy XXXXiiiinnnneeeetttt ((((11117777 JJJJaaaannnn 1111999999998888 8888....7777)))) KKKKUUUUNNNNAAAARRRRCCCC((((1111)))) iiiinnnnffffiiiilllleeee This may be a directory (in which case all regular files in _i_n_f_i_l_e are processed). FFFFIIIILLLLEEEESSSS ./.HSancillary File for additional file information needed by Macintosh. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS _K_u_n_a_r_c can be run in batch mode in conjunction with _f_i_n_d. (You should run _k_u_n_a_r_c as root if you use this method). If you are doing this, we suggest piping stdout into a log file so you can look at stderr for any errors. If you don't have a backup of your filesystem, we suggest you don't use the remove option if you use _k_u_n_a_r_c in batch mode. Instead, you can use another _f_i_n_d command to remove the archive files once _k_u_n_a_r_c has been run successfully. (See examples below). Convert all AppleDouble files in the directory tree rooted at /_u_s_r/_m_o_u_n_t to K-AShare format: find /usr/mount -name "%*" -exec kunarc {} \; Convert all A/UX files in the directory tree rooted at /_u_s_r/_m_o_u_n_t to K-AShare format: find /usr/mount -type d -name ".AppleDouble" -prune -exec kunarc {} \; If this succeeds without incident, use the following commands to remove the A/UX directories (which will no longer be necessary). find . -name ".AppleDouble" -prune -exec rm -r {} \; Convert all CAP-AUFS files in the directory tree rooted at /_u_s_r/_m_o_u_n_t to K-AShare format: find /usr/mount -type d -name ".finderinfo" -prune -exec kunarc {} \; If this succeeds without incident, use the following commands to remove the CAP directories (which will no longer be necessary). find . -name ".finderinfo" -prune -exec rm -r {} \; find . -name ".resource" -prune -exec rm -r {} \; Convert all TOPS files in the directory tree rooted at /_u_s_r/_m_o_u_n_t to K-AShare format: find . -name ".rsrc" -prune -o -type f -exec kunarc {} \; If this succeeds without incident, use the following commands to remove the TOPS directories (which will no longer be necessary). Page 3 (printed 3/26/98) KKKKUUUUNNNNAAAARRRRCCCC((((1111)))) KKKK----AAAASSSShhhhaaaarrrreeee bbbbyyyy XXXXiiiinnnneeeetttt ((((11117777 JJJJaaaannnn 1111999999998888 8888....7777)))) KKKKUUUUNNNNAAAARRRRCCCC((((1111)))) find . -name ".rsrc" -exec rm -rf {} \; Convert all Helios EtherShare files in the directory tree rooted at /_u_s_r/_m_o_u_n_t to K-AShare format: find . -name ".rsrc" -type d -exec kunarc {} \; Convert all IPT uShare files in the directory tree rooted at /_u_s_r/_m_o_u_n_t to K-AShare format: find . -name ".rsrc" -type d -exec kunarc -U {} \; You also need to change the directory names from Helios' or IPT's 8 bit character encoding scheme to Xinet's encoding scheme. This has to be done as a separate step as the find command gets confused when directories being searched change names. Run kunarc with the -h flag at the root of the Helios EtherShare or IPT uShare directory tree: kunarc -h /usr/mount If all this succeeds without incident, use the following commands to remove the EtherShare or uShare directories (which will no longer be necessary). find . -name ".rsrc" -type d -exec rm -rf {} \; Convert all K-AShare files in the directory tree rooted at /_u_s_r/_m_o_u_n_t to AppleDouble format (type as one line): find /usr/mount \( -type d -name ".HSResource" -prune \) -o \( -name ".HSancillary" \) -o -type f -exec karc -D -r {} \; Convert _A_M_a_c_F_i_l_e into _u_u, which can be appended to messages sent to AppleLink accounts via the Internet AppleLink gateway (e.g. XINET@applelink.apple.com). AppleLink will convert the enclosure back to the original Macintosh file. karc -A -f - AMacFile | uuencode AMacFile >! uu SSSSEEEEEEEE AAAALLLLSSSSOOOO _K-_A_S_h_a_r_e _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e BBBBUUUUGGGGSSSS The tolerant flag does not always work. If _k_u_n_a_r_c is used in conjunction with _f_i_n_d(_1) and the remove flag is on, _f_i_n_d may be confused when _k_u_n_a_r_c deletes files. This will result in spurious error messages (usually something like "cannot stat <filename>"), which may be Page 4 (printed 3/26/98) KKKKUUUUNNNNAAAARRRRCCCC((((1111)))) KKKK----AAAASSSShhhhaaaarrrreeee bbbbyyyy XXXXiiiinnnneeeetttt ((((11117777 JJJJaaaannnn 1111999999998888 8888....7777)))) KKKKUUUUNNNNAAAARRRRCCCC((((1111)))) ignored. _k_u_n_a_r_c doesnt do the right thing when given the dataforks for Helios EtherShare and IPT uShare files. Give it the file in the .rsrc directories. _K_a_r_c supports only MacBinary, AppleSingle and AppleDouble. Page 5 (printed 3/26/98)